EffectStopCollection<T> Class

Abstract base class for all EffectStop collections.

Syntax

Visual Basic

'Declaration
 
Public MustInherit Class EffectStopCollection(Of T As EffectStop) 

C#

public abstract class EffectStopCollection<T> 
where T: EffectStop

Type Parameters

T

The type for which the EffectStopCollection is being created.

Remarks

All EffectStopCollections are derived from this abstract generic base class which provides implementations for functionality required by all derived effect-specific classes. Refer to the documentation for EffectStop for a full discussion of how to use EffectStops to apply parent effects to items in a XamCarouselPanel

There are 5 supported effect stop types for this abstract base generic collection:

• OpacityEffectStop - Defines an EffectStop used to apply Opacity effects to items.
• ScalingEffectStop - Defines an EffectStop used to apply Scaling effects to items.
• SkewAngleXEffectStop - Defines an EffectStop used to apply Skewing effects about the X-axis to items.
• SkewAngleYEffectStop - Defines an EffectStop used to apply Skewing effects about the Y-axis to items.
• ZOrderEffectStop - Defines an EffectStop used to apply ZOrder effects to items to control their positions in the Z-space.

Refer to the Carousel Architecture Overview topic in the Developer's Guide for an explanation of how Carousel presentation works.

Example

In the following example, the UseOpacity has been set to true so that the panel will utilize the OpacityEffectStops that have been provided. Since the OpacityEffectStopDirection is set to Vertical, the offsets are calculated with regards to that orientation and items at the bottom will be fully opaque and the items as you move further from the bottom will be more transparent.

XAML

<igWindows:XamCarouselPanel>
    <igWindows:XamCarouselPanel.ViewSettings>
        <igWindows:CarouselViewSettings 
            UseOpacity="True"
            OpacityEffectStopDirection="Vertical"
            ItemPathRenderBrush="#77000000">

            <igWindows:CarouselViewSettings.ItemPath>
                <Path Data="M 0,0 100,100, 200,0" />
            </igWindows:CarouselViewSettings.ItemPath>

            <igWindows:CarouselViewSettings.OpacityEffectStops>
                <igWindows:OpacityEffectStopCollection>
                    <igWindows:OpacityEffectStop/>
                    <igWindows:OpacityEffectStop Offset="0.20" Value="0.10"/>
                    <igWindows:OpacityEffectStop Offset="0.50" Value="0.40"/>
                    <igWindows:OpacityEffectStop Offset="0.80" Value="0.60"/>
                    <igWindows:OpacityEffectStop Offset="1" Value="1"/>
                </igWindows:OpacityEffectStopCollection>
            </igWindows:CarouselViewSettings.OpacityEffectStops>                                        
            
        </igWindows:CarouselViewSettings>
    </igWindows:XamCarouselPanel.ViewSettings>

    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Red" />
    <Ellipse Width="100" Height="50" Stroke="Black" Fill="Green" />
    <Polygon Points="0, 25, 25, 0, 75, 0, 100, 25, 75, 50, 25, 50" Stroke="Black" Fill="Yellow" />
    <Rectangle Width="100" Height="50" Stroke="Black" Fill="Purple" />
    <Polyline Points="0, 25, 25, 0, 50, 25, 25, 50, 0, 25" Stroke="SlateGray" StrokeThickness="2" Fill="Blue"/>
    <Path Stroke="Black" Fill="Gray" Data="M 10,10 C 10,100 100,-100 100,10" />
</igWindows:XamCarouselPanel>

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2